home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1994 November: Tool Chest / Dev.CD Nov 94.toast / Sample Code / Newton Sample Code 1.2 / User Interface Guidelines / infoButton-1 / infoButton.README < prev    next >
Encoding:
Text File  |  1994-07-07  |  1.7 KB  |  53 lines  |  [TEXT/R*ch]
  1. InfoButton
  2. Copyright © 1994 by Apple Computer, Inc.  All rights reserved.
  3. by Maurice Sharp (with thanks to Newton UI team)
  4.  
  5. This sample provides a user proto for an application Info button. This button
  6. brings up a pick list that can be used for Application specific Help, Prefs
  7. and About information.
  8.  
  9. This info button will eventually become a standard user interface widget.
  10.  
  11. To use the protoInfoButton you will need to include both the protoInfoButton
  12. and protoInfoButton.rsrc files in your project.
  13.  
  14. In your project, drag out the protoInfoButton in your status bar.
  15. You will need to provide the following methods/slots:
  16.  
  17.  
  18. AppInfoItems
  19.  
  20. This is generally defined in the base view, though it can be define in
  21. the protoInfoButton if you want. The protoInfoButton will use inheritance
  22. to find this array.
  23.  
  24. An array of items that will be used to construct the pick list in the
  25. protoActionButton. These will be searched for using inheritance.
  26.  
  27. The order of items MUST be:
  28.  
  29. About
  30. Help
  31. Prefs
  32. 'pickSeparator
  33. <app specific items>
  34.  
  35. If you do not have all of About, Help and Prefs, keep the ordering listed
  36. above, but leave out the unused items.
  37.  
  38. If you do not have any application specific items, do not include the
  39. pick separator.
  40.  
  41. Note that application specific items should be global in nature. That is,
  42. they should specify a global state or initiate a global action.
  43.  
  44.  
  45. pickActionScript
  46.  
  47. a function as described in NPG 2-65 (protoInfoButton uses DoPopup).
  48. This is called when the user chooses an item from the pick list 
  49. created by the protoActionButton. You should respond appropriately.
  50.  
  51. NOTE: You MUST call :Hilite(nil) at the beginning of the pickActionScript,
  52. otherwise the Info button will NOT unhilite.
  53.